home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / initnsema_mutex.z / initnsema_mutex
Encoding:
Text File  |  1998-10-30  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. iiiinnnniiiittttnnnnsssseeeemmmmaaaa____mmmmuuuutttteeeexxxx((((DDDD3333XXXX))))                                      iiiinnnniiiittttnnnnsssseeeemmmmaaaa____mmmmuuuutttteeeexxxx((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa______mmmm_uuuu_tttt_eeee_xxxx - initialize a mutex semaphore to one
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_""""
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_ssss_eeee_mmmm_aaaa_...._hhhh_""""
  14.  
  15.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa______mmmm_uuuu_tttt_eeee_xxxx_((((_ssss_eeee_mmmm_aaaa______tttt _****_s_e_m_a_p_,,,, _cccc_hhhh_aaaa_rrrr _****_n_a_m_e_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa______mmmm_uuuu_tttt_eeee_xxxx initializes an IRIX mutual exclusion (mutex) semaphore (a
  19.      structure of type _s_e_m_a__t). Use mutex semaphores to synchronize access to
  20.      critical sections. You must allocate a semaphore before you can use it in
  21.      a semaphore operation, such as _pppp_ssss_eeee_mmmm_aaaa or _vvvv_ssss_eeee_mmmm_aaaa.  You can declare
  22.      semaphores in line by using the _s_e_m_a__t type, or you can allocate them
  23.      dynamically by using the kernel memory allocator, _kkkk_eeee_rrrr_nnnn______mmmm_aaaa_llll_llll_oooo_cccc(D3X). In
  24.      the case of an already allocated semaphore struct, initsema_mutex fills
  25.      it.
  26.  
  27.      The _n_a_m_e parameter of _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa expects a pointer to an eight character
  28.      string that contains the name you want to assign to the semaphore. This
  29.      name may be used by debugging utilities.
  30.  
  31.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  32.      None
  33.  
  34.    SSSSeeeeeeee AAAAllllssssoooo
  35.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa(D3X), _cccc_pppp_ssss_eeee_mmmm_aaaa(D3X), _cccc_vvvv_ssss_eeee_mmmm_aaaa(D3X), _pppp_ssss_eeee_mmmm_aaaa(D3X), _vvvv_ssss_eeee_mmmm_aaaa(D3X),
  36.      _ssss_llll_eeee_eeee_pppp(D3), _vvvv_pppp_ssss_eeee_mmmm_aaaa(D3X), _SSSS_LLLL_EEEE_EEEE_PPPP______AAAA_LLLL_LLLL_OOOO_CCCC(D3), _SSSS_LLLL_EEEE_EEEE_PPPP______DDDD_EEEE_AAAA_LLLL_LLLL_OOOO_CCCC(D3)
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.